- Install react-native-nitro-modules@0.35.9 (peerDep) + nitrogen@0.35.9 (devDep)
- Add nitro.json config with onramper namespace
- Add nitrogen codegen script
- Podspec: remove ExpoModulesCore dep, narrow source_files to Hybrid*.swift/Nitro*.swift
- Delete expo-module.config.json (Expo autolinking manifest)

…native.config.js

- src/specs/OnramperNitro.nitro.ts + nitrogen-generated specs
- ios/HybridOnramperNitro.swift (Promise.async)
- nitro.json autolinking (0.35.9 ios.implementationClassName form)
- react-native.config.js (package) + example-bare/react-native.config.js (consumer,
  explicit root+podspecPath) so RN-CLI autolinks the package through the file:.. symlink
- pod install links both NitroModules + OnramperReactNative

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ense :file

- package-side react-native.config.js used dependency.platforms.ios.podspecPath,
  which RN 0.85 CLI rejects as invalid (warns on every launch). The example links
  via the consumer-side example-bare/react-native.config.js instead.
  Real-consumer (npm-install) autolinking to be validated in Phase 4.
- podspec license dropped the unreadable ../LICENSE :file reference.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

RN 0.81+ defaults to a precompiled React Native Core whose distribution
doesn't expose module maps for Swift, causing 'No such module React' in the
stock AppDelegate.swift and our Nitro pod (cascading to HybridOnramperNitroSpec
not in scope). Set ENV in the Podfile to build RN core from source.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…resolve

nitrogen's add_nitrogen_files appends source globs (nitrogen/generated/**)
relative to the podspec dir. With the podspec in ios/, those resolved to
ios/nitrogen/** (nonexistent), so the generated HybridOnramperNitroSpec.swift
was never compiled -> 'cannot find type HybridOnramperNitroSpec in scope'.
Moved podspec to repo root (Nitro convention); ios/-prefixed our own sources.

Also includes example-bare Podfile SWIFT_ENABLE_EXPLICIT_MODULES=NO fix (Xcode 26
explicit modules -> module map not found) and consumer config podspecPath update.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…sh nitrogen output

Validated empirically (prebuilt-core ON + explicit-modules OFF builds clean):
SWIFT_ENABLE_EXPLICIT_MODULES=NO is the sole required RN0.85/Xcode26 fix — it
also resolves the earlier 'No such module React', so the faster precompiled
React Native Core can stay enabled. Removed the source-build override.

package.json files: add nitrogen/generated + the root OnramperReactNative.podspec
so real npm consumers get the generated specs and podspec.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- #2 sdkProbe(): import OnramperSDK, construct a real Environment value — proves
  the vendored xcframework links under Nitro's Swift/C++ interop.
- #3 HybridNitroSpikeView: a Nitro View hosting SwiftUI via UIHostingController
  (Phase 2's checkout-button pattern). View spec scoped to { ios: 'swift' } since
  Nitro views otherwise demand a Kotlin impl too.
- #4 startTicker/stopTicker: stores a JS callback natively + fires on a timer
  (event-stream mechanism); stopTicker releases it (cleanup path).
- podspec: add install_modules_dependencies(s) for RN new-arch Fabric/Yoga
  header paths (Nitro view pulls in React-Fabric -> yoga/style/Style.h).

Verified: BUILD SUCCEEDED on iOS simulator.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ble in dark mode

Spike gate passed on device: proofs #1-#4 all confirmed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

… + events + session

Replaces the Expo Modules bridge with a Nitro HybridObject wrapping
OnramperSDK.OnramperClient, designed against the SDK (not the Expo-era bridge):
- HybridOnramperNitro.swift: wraps OnramperClient; mirrors $state (Combine) and
  the events AsyncStream to single JS callbacks; feeds sessionExpirationHandler
  directly from a stored Nitro async callback (drops the token/continuation dance).
- OnramperSDKBridge.swift: SDK enum -> JS dict mapping + JSON-string transport
  (OnramperState/CheckoutEvent are non-Codable); error code/info, no [info:] folding.
- OnramperClient.ts: same public API (initialize/reset/signOut/addStateListener/
  addEventListener/destroy); per-client native instance; JSON parsed to typed unions.
- errors.ts: dropped the Expo message-folding regex.
- Removed spike code + the Expo checkout view (returns as a Nitro view in Phase 2).
- package.json: source/react-native field so the example bundles from src.

Verified: BUILD SUCCEEDED on iOS simulator.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- new react-native-nitro-modules mock (per-instance createHybridObject capturing
  the registered state/event/session callbacks); drop the expo-modules-core mock.
- OnramperClient.test: cover configure/initialize/signOut, session-handler
  resolve+reject, state/event fan-out, and destroy()->dispose(). 12 passing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…uirements

- OnramperCheckoutButton Nitro view (HybridOnramperCheckoutButton.swift) hosts the
  SDK's SwiftUI OnramperCheckoutButton via UIHostingController, consumed from
  PreparedIntentRegistry.shared by handle; re-attaches as a child VC so the button
  can present its login/webview sheets.
- getCheckoutRequirements/cancelPreparedIntent on HybridOnramperNitro: decode the
  JSON request/style (OnramperCheckoutBridge.swift), call the SDK, stash the button
  by ULID handle, return { intentHandle, quoteJson }.
- PreparedIntentRegistry: shared singleton (module stores, view consumes by handle).
- OnramperClient.ts: getCheckoutRequirements (returns a button element + quote) +
  cancelPreparedIntent restored; OnramperCheckoutButtonView re-added as a Nitro view.
- Deleted all remaining legacy Expo Swift (module + view + Bridging/*); podspec
  source_files simplifies to ios/*.swift. tsconfig: resolveJsonModule for the
  generated view config.

Verified: BUILD SUCCEEDED on iOS simulator; typecheck/lint/jest(12) green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

The current OnramperSDK adds 5 provider-lifecycle events (providerReady,
paymentAuthorized, paymentProcessing, paymentCancelled, providerError) emitted by
third-party checkout webviews. Map them in OnramperSDKBridge.toJSDict() + add them
to the typed CheckoutEvent union. Surfaced by rebuilding the xcframework from the
current onramper-sdk source (which also carries the ff29281 App Attest self-heal).

Note: the vendored xcframework is gitignored (fetched per release); this commit is
the wrapper-side event handling. A proper SDK release should ship the new binary.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Replace the last loose `response: unknown` with CheckoutFinalizeResponse /
HeadlessCheckoutData mirrored from Sources/OnramperSDK/Models/CheckoutFinalizeResponse.swift,
and export them. (errors.ts info stays Record<string,unknown> — genuinely open-ended.)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

app.plugin.js applies the two iOS requirements that aren't Expo defaults:
- ios.deploymentTarget 16.4 (vendored OnramperSDK.xcframework requires it)
- SWIFT_ENABLE_EXPLICIT_MODULES=NO (Xcode 16+/26 + CocoaPods + Swift pods)
Registered in package.json files; @expo/config-plugins as a devDep.

example/ (Expo) wired to consume the Nitro package: react-native-nitro-modules dep,
newArchEnabled, the plugin in app.json, bundle id com.onramper.demo.react-native-expo
(distinct from the bare example so both coexist on-device), prebuilt + BUILD SUCCEEDED.

Notable: Expo autolinking discovers the package's root podspec automatically — no
consumer react-native.config.js needed (unlike the bare RN-CLI + file:.. symlink case).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

The example consumes the package via file:.., and Metro's symlink-dedup config
(disableHierarchicalLookup + nodeModulesPaths=[example/node_modules]) requires the
Nitro peer dep to be physically in example/node_modules. Installed with
--legacy-peer-deps (pre-existing @react-native/new-app-screen 0.85.2-vs-0.85.3 peer
mismatch) + --ignore-scripts (the file:.. package's expo-module prepare otherwise
clobbers tsconfig.json + fails). Restores tsconfig resolveJsonModule.

NOTE: expo-module-scripts' prepare regenerating tsconfig.json is fragile — Phase 4
should drop expo-module-scripts (→ plain tsc) to stop the clobbering.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Public-facing docs were still written for the Expo Modules era. Updated to the
Nitro reality:
- Install: react-native-nitro-modules peer dep + New Architecture; bare RN and
  Expo (via the bundled config plugin) — dropped install-expo-modules and the
  mandatory ExpoReactNativeFactory AppDelegate section entirely.
- iOS setup: bare-RN Podfile (deployment target 16.4 + SWIFT_ENABLE_EXPLICIT_MODULES=NO);
  Metro/Babel use standard RN defaults for bare RN.
- Events: documented the 5 provider-lifecycle events; removed the obsolete
  'checkoutCancelled not surfaced' + per-view-handler caveats.
- Cleanups: dropped the objectVersion sed workaround, fixed the file:.. symlink
  contributor note (Nitro module names + bare-RN autolinking), converted the
  going-live checklist to plain bullets (no checkbox/todo rendering).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Complete the Expo->Nitro migration on the packaging side. A Nitro module
needs no Expo build tooling, and expo-module-scripts' `prepare` step was
rewriting tsconfig.json on every install (stripping resolveJsonModule and
the nitrogen json include), which broke `tsc` / `npm ci` locally and in CI.

- swap JS/TS build to react-native-builder-bob (commonjs+module+typescript);
  update main/module/types/exports/files for the lib/ layout
- self-contained tsconfig.json (no expo-module-scripts base) — permanently
  ends the tsconfig clobber
- vendor the nitrogen-generated Fabric view config into src/generated via
  scripts/sync-view-config.js (wired into `npm run nitrogen`) so bob's lib/
  output resolves the import correctly; nitrogen stays the source of truth
- drop the unused react-test-renderer devDep and the --legacy-peer-deps flag
  from ci.yml/release.yml (peer resolution is now clean)
- remove the vestigial universe-based .eslintrc.js (lint uses biome)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…n re-hosting

Addresses the PR #1 Copilot review feedback on the checkout flow.

- HybridOnramperNitro: replace the process-wide
  PreparedIntentRegistry.invalidateAll() with a per-instance
  lastPreparedHandle. getCheckoutRequirements now drops only this client's
  prior unconsumed handle before storing the new one (cleared in
  cancelPreparedIntent and dispose), so one client no longer invalidates
  other clients' checkout buttons.
- HybridOnramperCheckoutButton: host() now tears down the previously hosted
  UIHostingController via detachHosted() before installing the new one, so
  re-assigning intentHandle no longer accumulates subviews/constraints or
  leaves the old controller childed to the parent VC.
- Tests: cover getCheckoutRequirements (JSON request/style serialization,
  quote parsing, button element, buttonStyle default, native error wrapping)
  and cancelPreparedIntent forwarding; add both methods to the Nitro mock.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…od path

- example-bare: declare the App Attest entitlement
  (com.apple.developer.devicecheck.appattest-environment = development) so
  on-device checkout works with the SDK, matching the Expo example.
- example Podfile.lock: correct the NitroModules pod path from
  ../../node_modules to ../node_modules and refresh the OnramperReactNative
  checksum.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

The auto GITHUB_TOKEN is scoped to this repo only and can't read the
private onramper/onramper-ios release. Pass a fine-grained PAT via
GH_TOKEN so `gh release download` can authenticate cross-repo. Remove
once onramper-ios is public.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…o app to example-expo

Since the Nitro migration the bare React Native app is the canonical
example, so make the directory layout reflect that:

- example (Expo)      -> example-expo
- example-bare (bare) -> example

Rebrand the bare app's identity OnramperBare -> OnramperExample across
package.json, app.json, Android rootProject.name / app_name,
getMainComponentName, iOS moduleName, and the iOS target / scheme /
project / workspace / Podfile target. Android applicationId
(com.onramperbare) and iOS bundle id (com.onramper.demo.react-native)
are intentionally unchanged so signing/install identity stays stable.

Disambiguate the Expo app's package name to
onramper-react-native-example-expo, and replace its stock RN-CLI README
with Expo-specific launch steps (prebuild + dev client, env.local.ts,
xcframework fetch).

Update root references: .gitignore example/* -> example-expo/* (Expo
artifacts) and example-bare/env.local.ts -> example/env.local.ts;
tsconfig exclude example-bare -> example-expo.

Both apps verified building: example (xcodebuild) and example-expo
(expo run:ios) build and launch on simulator.